home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / gamble.zip / GAMBLE.DOC < prev    next >
Text File  |  1991-06-29  |  16KB  |  530 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                  ┌────────────────────────────────────────────┐
  15.                  │                                            │
  16.                  │              GAMBLE 'N GUESS               │
  17.                  │           =======================          │
  18.                  │                                            │
  19.                  │         A Live Game for Many BBS's         │
  20.                  │                                            │
  21.                  │   Game Release Version 3.0 - 01/01/91      │
  22.                  │                                            │
  23.                  │             (C)opyright 1988               │
  24.                  │                                            │
  25.                  │                   By                       │
  26.                  │                                            │
  27.                  │            SECRET SERVICE BBS              │
  28.                  │                                            │
  29.                  │              Mike Wilson                   │
  30.                  │             P.O. Box 9521                  │
  31.                  │            Huntington, WV                  │
  32.                  │                  25704                     │
  33.                  │                                            │
  34.                  │            BBS (304) 429-6838              │
  35.                  │           1200/2400/9600  24 hrs.          │
  36.                  │                                            │
  37.                  │                                            │
  38.                  │                                            │
  39.                  │                                            │
  40.                  └────────────────────────────────────────────┘
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                    Gamble N' Guess  (C)opyright 1988 - Page 1
  67.  
  68.                                   Warranty
  69.  
  70.  
  71. This is product is provided "as is" without warranty of any kind.  The
  72. entire risk as to the results and performance of the program is assumed by
  73. you. Futher more, I the author do not warrant, guarantee, or make any
  74. representations regarding the use of, or the results of the use of the program,
  75. and you rely on the program and results solely at your own risk.  I the author
  76. cannot accept responsibility for system damage, loss of profit, or any other
  77. special, incidental, or consequential damages resulting from the use or
  78. inability to use this product.
  79.  
  80.                                  Copyright
  81.  
  82.  
  83. The Multi-Board Gamble N' Guess live game is distributed as SHAREWARE.
  84. Under this concept you may use the SHAREWARE (unregistered) version for a
  85. reasonable period of time, which I consider to be three weeks, after which you
  86. must either register your copy or discontinue usage.
  87.  
  88.                                Registration
  89.  
  90. With registration you will recieve the latest registered copy of Gamble N'
  91. Guess with the ability to download any futher updates from Secret Service BBS
  92. at no extra  cost. You will also recieve any support the author can give
  93. in reference to bugs or other problems that may arise in using the game.
  94.  
  95. I feel that sysop's have enough expense without charging a high cost for a game
  96. for their users. I have set the cost of registration at $10.00 which I feel
  97. if people will follow the shareware concept will be enough to cover shipping
  98. and handling and encourage me to write more doors.
  99. See register.txt for ordering instructions.
  100.  
  101.  
  102.                                Distribution
  103.  
  104. You are free, in fact encouraged, to distribute the SHAREWARE (unregistered)
  105. version of the Multi-Board Gamble 'N Guess Live Game provided that all files
  106. contained in the original Gamble N' Guess archive are distributed in their
  107. original unmodified state.
  108.  
  109.  
  110.                                Introduction
  111.                                      &
  112.                                 How To Play
  113.  
  114. The game of Gamble 'N Guess is played much like the shell games that you see
  115. at a Carnival. A ball is placed under one of the shells and then the shells
  116. are mixed up. You have up to 15 plays per day to make wagers and to guess
  117. which shell the ball was placed under. If you win then the wager is added
  118. to your totals.
  119.  
  120.                           Options and Information
  121.  
  122. This door is one of the few that 40 column users can play. The game works
  123. with Commodores, CoCo's as well as IBM'ers.
  124. This door game will also create color and mono top 10 bulletins and write them
  125. in directories of your choice written in the .CFG file. It also has a in depth
  126. LOG capability which is optional by the sysop. The log will tell if the user
  127. completed the game, quit before playing, quit in the middle,
  128. dropped carrier, time limit exceeded, no input in 3 minutes and more.
  129. This option was added so that the sysop could see just what his user's are
  130. doing when entering the game. Like whther they play it or just look and quit.
  131.  
  132.                    Gamble N' Guess  (C)opyright 1988 - Page 2
  133.  
  134.                             Installation and Setup
  135.  
  136. Installation procedures are relatively simple.
  137. Create a new directory and dissolve the contents of Gamble.zip into it.
  138. Run Setup.exe and answer the questions as they appear.
  139. If you have problems answering a particular question refer to the detailed
  140. description of each file below.
  141. Create a batch file to call the door from your BBS. If you don't know how
  142. to do this please read the section of this file titled BATCH FILES.
  143.  
  144. The following is a listing of what is in each file:
  145.  
  146. GAMBLE.CFG contains:
  147.  
  148. The Secret Service BBS           <-- Name of BBS
  149. Mike                             <-- Sysop's first name
  150. Wilson                           <-- Sysop's last name
  151. C:\Path\BBSinfo.???  <-- Path and filename for Board Info File (See below)
  152. C:\Path\Color.scr    <-- Path & Filename to create COLOR bulletin
  153. C:\Path\Mono.scr     <-- Path & Filename to create MONO bulletin
  154. NO                   <-- NO or locked COM PORT Baud Rate
  155. LOG                  <-- LOG to keep user log or N for No log
  156. U                    <-- U for Unlimited plays per day O for Once per day
  157.  
  158. The line that asks for Board Info file refers to the path and file name of
  159. the file that your particular BBS creates when it drops out to run a door.
  160. This would be:
  161. Wildcat up to 2.0   -> Callinfo.bbs        PCBoard ----> PCBoard.sys
  162. GAP or Wildcat 3.0+ -> Door.sys            Spitfire ---> SFDoors.dat
  163. QuickBBS ----------> DorinoX.def (The X is 1 or 2 depending on Node #)
  164.  
  165. A proper example of the line would be: c:\Wildcat\callinfo.bbs
  166.  
  167. The lines refering to Color and Mono Top ten bulletins can be any proper
  168. Path and DOS filename that you want these bulletins written to.
  169.  
  170. NOTE FOR MULTI NODES!
  171. ----------------------
  172. You may now have several .cfg files to allow use on multinode systems.
  173. Use the above .cfg format but name each .cfg file differently. You
  174. may call them what you want as long as you correctly call them from
  175. the batch file command line.
  176.  
  177. Example:    Node1:     game game.cfg
  178.  
  179.             Node2:     game game1.cfg
  180.  
  181. ** If you need to alter the Com 3 or 4 address or IRQ then please read
  182.    the file called Port.Doc for instructions!
  183.  
  184. Gamble.DAT contains:
  185.  
  186. This file contains the following user data:
  187.  
  188. "The Champion","11-01-1988","100"
  189. "Mike Wilson","11-23-1988","100"
  190.  
  191. Data has to be kept in this format, but you can delete all lines except for
  192. line number 1 which is the Last Months Champ line. You can alter line 1 but
  193. not remove it. You need to alter line 1's Date form 11-01-1988 to the month
  194. that your setting up this door. For example if it is December just simply
  195. change the Date to 12-01-1988. It doesn't matter if it's the 1st or the 10th,
  196. only the Month (12) will make any difference.
  197.  
  198.                    Gamble N' Guess  (C)opyright 1988 - Page 3
  199.  
  200.  
  201. GAMBLE.TXT contains:
  202.  
  203. This is the instruction file for Gamble N' Guess. When a user selects the
  204. See Instructions option during the game, this file is read for
  205. instructions. This file MUST BE PRESENT and Not altered in any way for
  206. Gamble N' Guess to run properly
  207.  
  208. BOARD.TXT
  209. ---------
  210. Don't worry about this file. It is created when you run setup.exe
  211. This file tells the game which BBS Software you are running and
  212. tells it to read the correct board file. THERE SHOULD NOT BE A
  213. BOARD.TXT FILE IN THE GAME DIRECTORY IF YOUR RUNNING WILDCAT
  214. PRIOR TO VERSION 3.0!
  215. The game looks for this file and defaults to Wildcat if it isn't
  216. found.
  217.  
  218. For other boards it will contain one line with one of the following:
  219. QuickBBS --------> QBBS         GAP or Wildcat 3.0+ --> GAP
  220. PCBoard ---------> PCB          Spitfire -------------> SPITFIRE
  221.  
  222.  
  223.  
  224.  
  225.  
  226.                           List of Files In Archive
  227.  
  228. The following files are either found in your Gamble N' Guess Arc or will be
  229. created during the runtime execution of the game.
  230.  
  231.  
  232. SETUP.EXE     <--- Executable Setup program for game
  233.  
  234. GAMBLE.EXE    <--- Executable Program.
  235.  
  236. GAMBLE.CFG   #<--- Configuration File.
  237.  
  238. GAMBLE.DAT    <--- Store User's Name, Last Play Date & Score.
  239.  
  240. GAMBLE.TXT    <--- Instructions Used By Program.
  241.  
  242. BULLET##.SCR *<--- COLOR Bulletin
  243.  
  244. BULLET##.BBS *<--- MONO Bulletin
  245.  
  246. GAMBLE.LOG   *<--- User Log File
  247.  
  248. GAMBLE.DOC    <--- This File.
  249.  
  250. PORT.DOC      <--- Instructions for altering Com 3 or 4 Address or IRQ
  251.  
  252. * DENOTES that file is created during RUN-TIME.
  253. # DENOTES that file is created during Setup.exe execution
  254.  
  255.  
  256.  
  257.                                   Batch Files
  258.                                =================
  259.  
  260. Be sure that you have edited or created the GAMBLE.CFG file with the correct
  261. information as described earlier in these docs. The individual setups do not
  262. repeat this necessary process.
  263.  
  264.                    Gamble N' Guess  (C)opyright 1988 - Page 4
  265.  
  266.  
  267.  
  268.  
  269. Wildcat! 1.13 & 2.0+ Setup:
  270. ---------------------------
  271. First, create your DOOR##.BAT (2.0+) or LIVE##.BAT (1.13) like this eample:
  272.  
  273.    ECHO OFF
  274.    CD \WILDCAT\DOORS\GAMBLE
  275.    GAMBLE GAMBLE.CFG
  276.    CD \WILDCAT
  277.    CAT.BAT
  278.  
  279. place this batch file in your Node# directory if running Multi-Nodes or in
  280. your Wildcat (default) directory if single node.
  281.  
  282. Second, Create a sub-directory for the door program such as in the following
  283. example:
  284.  
  285. C:\WILDCAT\DOORS\GAMBLE
  286.  
  287. Third, put the GAMBLE game files in the \WILDCAT\DOORS\GAMBLE directory.
  288.  
  289. Forth, add this game to your live program menu for user selection and your
  290. ready to run the door.
  291.  
  292. If this is a little unclear then please read your systems documentation for
  293. more detailed instructions.
  294.  
  295. If you use a door monitoring program then read their documentation for
  296. their specific setup.
  297.  
  298.  
  299.  
  300. Gap Setup:
  301. ----------
  302. First, add the number and name of the door to your menu. This will allow the
  303. user to select the door by number.
  304.  
  305. Second, edit or create the file called DOORS.DAT which is normally in the GEN
  306. directory. Following is an example line to add:
  307.  
  308.    GG 10
  309.  
  310. where 'GG' stands for the name of the batch file (shown below) to invoke the
  311. the door and '10' is the required security level.
  312.  
  313. Third, create a sub-directory for GAMBLE to be placed in. And example
  314. would be:
  315.  
  316. C:\GAP\GAMBLE
  317.  
  318. place all the files in the GAMBLE.ZIP archive inside this directory.
  319.  
  320. Forth, create a batch file called GAMBLE which should be placed in the
  321. default directory. Following is example contents of this file:
  322.  
  323.    ECHO OFF
  324.    CD\GAP\GAMBLE
  325.    GAMBLE GAMBLE.CFG
  326.    CD\GAP
  327.    GAP
  328.  
  329. the last line in the GAMBLE file should invoke the batch file which loads
  330. the GAP BBS system.
  331.  
  332.                    Gamble N' Guess  (C)opyright 1988 - Page 5
  333.  
  334. If this is a little unclear then please read your systems documentation for
  335. more detailed instructions.
  336.  
  337. If you use a door monitoring program then read their documentation for
  338. their specific setup.
  339.  
  340.  
  341. Spitfire Setup:
  342. ---------------
  343. First edit your SFDOOR.MNU and add the following line. If you are not running
  344. and doors at this time you will need to create this file.
  345.  
  346.    GAMBLE, 10
  347.  
  348.    Where GAMBLE is the name of the door to appear on your menu and the 10
  349.    is the lowest security level that will be allowed to enter the door. Don't
  350.    forget the comma (,) after the name.
  351.  
  352. Second create a sub-directory to place the door game in. In this example we
  353. will use 'C:\SF\DOOR_A' for the game directory.
  354.  
  355.  
  356. Third move all the files in the GAMBLE.ZIP archive into this directory.
  357.  
  358. Forth edit your SF.BAT file adding the following lines.
  359.  
  360. :DOOR_A
  361.    CD\SF\DOORS_A
  362.    GAMBLE GAMBLE.CFG
  363.    CD\SF
  364.    GOTO LOOP
  365.  
  366. Fifth, rerun Sf.BAT and your ready to begin play.
  367.  
  368. If this is a little unclear then please read your systems documentation for
  369. more detailed instructions.
  370.  
  371. If you use a door monitoring program then read their documentation for
  372. their specific setup.
  373.  
  374.  
  375. PCBoard 14.0+ Setup:
  376. --------------------
  377. First, edit your DOORS and DOORSG file so that it shows GAMBLE with the door
  378. number relating to it's position in DOORS.DAT.
  379.  
  380. Second, edit the DOORS.DAT file so that it includes GAMBLE.
  381.  
  382. Third, create a sub-directory for GAMBLE to be placed in. And example
  383. would be:
  384.  
  385. C:\PCB\GAMBLE
  386.  
  387. place all the files in the GAMBLE.ZIP archive inside this directory.
  388.  
  389. Forth, create a batch file called GAMBLE which should be placed in the
  390. default directory. Following is example contents of this file:
  391.  
  392.    ECHO OFF
  393.    CD\PCB\GAMBLE
  394.    GAMBLE GAMBLE.CFG
  395.    CD\PCB
  396.    BOARD
  397.  
  398.                    Gamble N' Guess  (C)opyright 1988 - Page 6
  399.  
  400.  
  401.  
  402. the last line in the GAMBLE file should invoke the batch file which loads
  403. the PCboard BBS system.
  404.  
  405. If this is a little unclear then please read your systems documentation for
  406. more detailed instructions.
  407.  
  408. If you use a door monitoring program then read their documentation for
  409. their specific setup.
  410.  
  411.  
  412.  
  413.  
  414. QuickBBS Setup:
  415. ---------------
  416. First, add the game to your games menu and select the correct type for doors.
  417.  
  418. Second, create a sub-directory for the game and move all the files from the
  419. zip file to this directory.
  420.  
  421. Third, the game reads the file DORINFOx.DEF. Where 'x' is the node number.
  422. Since QuickBBS only supports one node at this time then this file should be
  423. 'DORINFO1.DEF'. This file's drive\path\filename should be on the third line
  424. of the configuration file.
  425.  
  426.    Note: It was told to me that the upcoming 3.0 version of QuickBBS will
  427.          support Multi-Nodes and that the 'DORINFOx.DEF' will be changed
  428.          to 'DORINFxx.DEF' to support Multi-Nodes. This game is written
  429.          where you can specify this new name as well as any others.
  430.  
  431. Forth, create a batch file called GAMBLE which should be placed in the
  432. default directory. Following is example contents of this file:
  433.  
  434.    ECHO OFF
  435.    CD\QUICKBBS\GAMBLE
  436.    GAMBLE GAMBLE.CFG
  437.    CD\QUICKBBS
  438.    QBBS.BAT
  439.  
  440. the last line in the GAMBLE file should invoke the batch file which loads
  441. the QuickBBS system.
  442.  
  443. If this is a little unclear then please read your systems documentation for
  444. more detailed instructions.
  445.  
  446. If you use a door monitoring program then read their documentation for
  447. their specific setup.
  448.  
  449.  
  450.                             Technical Support
  451.  
  452. If you have problems with the Multi-Board Gamble N' Guess live game you may
  453. contact Mike Wilson at the Secret Service BBS 24 hours per day.
  454.  
  455. Secret Service (304) 429-6838
  456.  
  457. PCRelay Net ID: ->SECRET        FIDO  1:262/29
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.                    Gamble N' Guess  (C)opyright 1988 - Page 7
  465.  
  466.                               Order Information
  467.  
  468.  
  469. Just mail Check or Money Order or Cash to:
  470.  
  471. Mike Wilson
  472. P.O. Box 9521
  473. Huntington, WV
  474.             25704
  475.  
  476. Make Checks out to Mike Wilson.
  477. Alll fund MUST be U.S.!
  478.  
  479. Thank you for trying Gamble N' Guess and look for more games and utilities
  480. in the near future.
  481.  
  482. Thanks to Jeff Sumberg for some great C routines used in this door!
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.                    Gamble N' Guess  (C)opyright 1988 - Page 8